feat(minibf): implement `/epochs/{number}/stakes` endpoint by mmahut · Pull Request #1152 · txpipe/dolos

mmahut · 2026-07-31T22:25:40Z

Resolves #1082.

Implements /epochs/{number}/stakes (#1082).

Serves the per-account stake distribution from the account-stakes log added in the base PR. One key-range scan per page, Blockfrost pagination (count/page), 404 above the current epoch, zero-amount rows filtered out to match dbsync.

Verified against hosted Blockfrost on preview and the known gap: the current epoch returns [] until its RUPD emission lands, so we lag hosted Blockfrost by one epoch. A follow-up can close this by emitting from the mark snapshot as well. Epochs before the node's sync start have no rows.

Summary by CodeRabbit

New Features
- Added an endpoint to retrieve stake distributions for a specific epoch.
- Supports pagination and returns stake addresses, pool IDs, and associated amounts.
- Excludes zero-stake entries from results.
- Provides clear handling for invalid, future, empty, or unavailable epochs.
Documentation
- Documented the new epoch stakes endpoint in the Mini Blockfrost API coverage.

coderabbitai · 2026-07-31T22:25:47Z

Caution

Review failed

The pull request is closed.

ℹ️ Recent review info

⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Pro Plus

Run ID: 5b75d52d-78fd-4039-b9d3-a6b40843785a

📥 Commits

Reviewing files that changed from the base of the PR and between e88bae1 and 9b37f9f.

📒 Files selected for processing (5)

crates/minibf/src/lib.rs
crates/minibf/src/routes/epochs/mod.rs
crates/minibf/src/test_support.rs
crates/testing/src/synthetic.rs
docs/content/apis/minibf.mdx

📝 Walkthrough

Walkthrough

Adds the Mini Blockfrost /epochs/{epoch}/stakes endpoint. The handler validates epochs, reads account stake logs, filters and paginates results, maps credentials and pool IDs, and returns stake responses. Synthetic fixtures, tests, and API documentation were added.

Changes

Epoch stake distribution

Layer / File(s)	Summary
Account stake log fixtures `crates/testing/src/synthetic.rs`, `crates/minibf/src/test_support.rs`	Adds account stake log seeding for positive and zero-balance entries. Test setup seeds the prior epoch and exposes the generated tip epoch.
Epoch stakes route and validation `crates/minibf/src/routes/epochs/mod.rs`, `crates/minibf/src/lib.rs`, `docs/content/apis/minibf.mdx`	Adds the route and handler. The handler validates epochs, scans and decodes stake logs, filters zero-stake records, applies pagination, maps response fields, and documents the endpoint. Tests cover success, pagination, empty epochs, invalid epochs, and storage failures.

Estimated code review effort: 3 (Moderate) | ~25 minutes

Possibly related PRs

txpipe/dolos#1145: Introduces the AccountStakeLog data consumed by this endpoint.
txpipe/dolos#731: Uses related epoch-scoped Mini Blockfrost route and pagination patterns.
txpipe/dolos#736: Uses related stake-log retrieval and epoch data mapping patterns.

Suggested reviewers: scarmuega

✨ Finishing Touches

📝 Generate docstrings

Create stacked PR
Commit on current branch

🧪 Generate unit tests (beta)

Create PR with unit tests
Commit unit tests in branch mmahut/epoch-stakes

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

_{Comment @coderabbitai help to get the list of available commands.}

Copilot

Pull request overview

Adds Blockfrost-compatible /epochs/{epoch}/stakes support to the minibf service by serving per-account epoch stake distribution from the archived account-stakes log (emitted by Cardano RUPD), with pagination and tests.

Changes:

Implement /epochs/{epoch}/stakes route that scans AccountStakeLog entries for the epoch-start temporal key, filters zero-amount rows, and maps results to Blockfrost models.
Extend synthetic test seeding to write AccountStakeLog rows and add endpoint tests (happy path, pagination, empty epoch, 404/400, fault handling).
Document the new endpoint in the minibf API docs and register the route in the router.

Reviewed changes

Copilot reviewed 5 out of 5 changed files in this pull request and generated 2 comments.

Show a summary per file

File	Description
docs/content/apis/minibf.mdx	Documents `/epochs/{epoch}/stakes` as a supported minibf endpoint.
crates/testing/src/synthetic.rs	Adds a helper to seed per-epoch `AccountStakeLog` entries for integration tests.
crates/minibf/src/test_support.rs	Seeds account-stake logs in the synthetic domain builder and adds a helper to compute tip epoch for tests.
crates/minibf/src/routes/epochs/mod.rs	Implements the new `/epochs/{epoch}/stakes` handler and adds comprehensive route tests.
crates/minibf/src/lib.rs	Wires the new endpoint into the Axum router.

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

+    let pagination = Pagination::try_from(params)?;
+


+    let inner = domain.inner.clone();
+    let skip = pagination.skip();
+    let count = pagination.count;
+


mmahut requested a review from scarmuega as a code owner July 31, 2026 22:25

mmahut requested a review from Copilot July 31, 2026 22:26

Copilot started reviewing on behalf of mmahut July 31, 2026 22:26 View session

Copilot AI reviewed Jul 31, 2026

View reviewed changes

mmahut force-pushed the mmahut/epoch-stakes branch from d6ecc38 to 2e67328 Compare July 31, 2026 22:45

mmahut added area:minibf Mini Blockfrost (minibf) API enhancement New feature or request labels Aug 6, 2026

scarmuega requested a review from a team as a code owner August 13, 2026 10:52

scarmuega force-pushed the mmahut/epoch-stakes branch 2 times, most recently from 319dee3 to bacef43 Compare August 13, 2026 11:54

scarmuega approved these changes Aug 13, 2026

View reviewed changes

Base automatically changed from mmahut/epoch-stake-log to main August 13, 2026 11:58

feat(minibf): implement /epochs/{number}/stakes endpoint (#1082)

9b37f9f

scarmuega force-pushed the mmahut/epoch-stakes branch from bacef43 to 9b37f9f Compare August 13, 2026 11:58

scarmuega merged commit aa85722 into main Aug 13, 2026
16 of 17 checks passed

Navigation Menu

Uh oh!

feat(minibf): implement `/epochs/{number}/stakes` endpoint - #1152

feat(minibf): implement `/epochs/{number}/stakes` endpoint#1152
scarmuega merged 1 commit into
mainfrom
mmahut/epoch-stakes

mmahut commented Jul 31, 2026 •

edited by coderabbitai Bot

Loading

Uh oh!

coderabbitai Bot commented Jul 31, 2026 •

edited

Loading

Review failed

Walkthrough

Changes

Uh oh!

Copilot AI left a comment

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

3 participants

Uh oh!

Conversation

mmahut commented Jul 31, 2026 • edited by coderabbitai Bot Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Summary by CodeRabbit

Uh oh!

coderabbitai Bot commented Jul 31, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Review failed

Walkthrough

Changes

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Pull request overview

Reviewed changes

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

3 participants

mmahut commented Jul 31, 2026 •

edited by coderabbitai Bot

Loading

coderabbitai Bot commented Jul 31, 2026 •

edited

Loading